Actions for Sprite Tracks
A sprite created at runtime is associated with the current sprite key frame. It will remain alive until a new sprite key frame is loaded. It has all the regular properties of a sprite including the new sprite property
kSpritePropertyActionHandlingSpriteID
which delegates its handling of wired events to another sprite. In QuickTime 4, runtime sprites cannot have there own unique event handling atoms.
Constant descriptions
-
kActionSpriteTrackNewSprite
-
Supported flags: none
Param1: [QTAtomID spriteID ] Param2: [ short imageIndex ] Param3: [ MatrixRecord matrix ] Param4: [ short visible ] Param5: [ short layer ] Param6: [ ModifierTrackGraphicsModeRecord graphicsMode] Param7: [ QTAtomID actionHandlingSpriteID ]
Dynamically creates a new sprite with the properties specified by the parameters. You may pass zero for the
spriteID
and a unique ID will be assigned.
-
kActionSpriteTrackDisposeSprite
-
Supported flags: none
Param1: [QTAtomID spriteID]
Disposes the sprite with the specified ID. Note that this disposes the sprite object in memory, it does not dispose the sprite from the media. If you dispose a sprite that exists in a sprite track's media, it will be created again the next time the key frame sample is loaded.
-
kActionSpriteTrackSetVariableToString
-
Supported flags: none
Param1: [QTAtomID variableID] Param2: [Cstring theString]
Sets the value of the sprite track variable specified by
variableID
to
theString
. This replaces the previous value of the variable. Variables may be either a string or a floating-point number.
-
kActionSpriteTrackConcatVariables
-
Supported flags: none
Param1: [QTAtomID firstVariableID] Param2: [QTAtomID secondVariableID] Param3: [QTAtomID resultVariableID]
Concatenates the string in the sprite track variable specified by
secondVariableID
to the end of the string in
firstVariableID
and places the result in the variable
resultVariableID
. Uninitialized string variables are the empty string. Variables containing floating-point numbers are coerced to strings.
-
kActionSpriteTrackSetVariableToMovieURL
-
Supported flags: none
Param1: [QTAtomID variableID] Param2: <[MovieTargetAtoms externalMovie]>
Sets the value of a sprite track variable to a string containing the URL of the movie that contains the sprite track, or optionally the URL of an external movie if the second parameter is used.
© 1999 Apple Computer, Inc.| Previous | Chapter Contents | Chapter Top | Next |